<?php

namespace Cekurte\Shortener\Url;

/**
 * Define os métodos que deverão ser implementados pelas API para encurtamento da URL
 *
 * @author     João Paulo Cercal
 * @version    1.0
 */
interface Adapter
{
    /**
     * Encurta uma URL longa
     * 
     * @param 	string $longUrl
     * 
     * @author 	João Paulo Cercal
	 * @version 1.0
     * 
     * @return 	string uma url encurtada, por exemplo: http://goo.gl/p9vgX
     */
    public function encurtar( $longUrl );
    
    /**
     * Desencurta uma url encurtada
     * 
     * @param 	string $shortUrl
     * @param 	bool $analytics Se true mostra o mapa da URL, do contrário não mostra. O padrão é false (não mostrar)
     * 
     * @author 	João Paulo Cercal
	 * @version 1.0
	 * 
     * @return 	string a url original
     */
    public function desencurtar( $shortUrl, $analytics = false );
} 